<?xml version='1.0' encoding='utf-8'?>
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <title>Pro Git - 简体中文版
</title>
    <meta content="http://www.w3.org/1999/xhtml; charset=utf-8" http-equiv="Content-Type"/>
    <link href="stylesheet.css" type="text/css" rel="stylesheet"/>
    <style type="text/css">
		@page { margin-bottom: 5.000000pt; margin-top: 5.000000pt; }</style>
  </head>
  <body class="calibre">
<h2 id="calibre_toc_26" class="calibre3">基本的分支与合并</h2>

<p class="calibre2">现在让我们来看一个简单的分支与合并的例子，实际工作中大体也会用到这样的工作流程：</p>

<ol class="calibre10"><li class="calibre7">开发某个网站。</li>
<li class="calibre7">为实现某个新的需求，创建一个分支。</li>
<li class="calibre7">在这个分支上开展工作。</li>
</ol><p class="calibre2">假设此时，你突然接到一个电话说有个很严重的问题需要紧急修补，那么可以按照下面的方式处理：</p>

<ol class="calibre10"><li class="calibre7">返回到原先已经发布到生产服务器上的分支。</li>
<li class="calibre7">为这次紧急修补建立一个新分支。</li>
<li class="calibre7">测试通过后，将此修补分支合并，再推送到生产服务器上。</li>
<li class="calibre7">切换到之前实现新需求的分支，继续工作。</li>
</ol><h3 id="calibre_toc_118" class="calibre4">基本分支</h3>

<p class="calibre2">首先，我们假设你正在项目中愉快地工作，并且已经提交了几次更新（见图 3-10）。</p>

<p class="calibre2"><img src="18333fig0310-tn.png" alt="图 3-10. 一部分简短的提交历史" title="图 3-10. 一部分简短的提交历史" class="calibre5"/></p>

<p class="calibre2">现在，你决定要修补问题追踪系统上的 #53 问题。顺带说明下，Git 并不同任何特定的问题追踪系统打交道。这里为了说明要解决的问题，才把新建的分支取名为 iss53。要新建并切换到该分支，运行 <code class="calibre9">git checkout</code> 并加上 <code class="calibre9">-b</code> 参数：</p>

<pre class="calibre8"><code class="calibre9">$ git checkout -b iss53
Switched to a new branch "iss53"
</code></pre>

<p class="calibre2">相当于下面这两条命令：</p>

<pre class="calibre8"><code class="calibre9">$ git branch iss53
$ git checkout iss53
</code></pre>

<p class="calibre2">图 3-11 示意该命令的结果。</p>

<p class="calibre2"><img src="18333fig0311-tn.png" alt="图 3-11. 创建了一个新的分支指针" title="图 3-11. 创建了一个新的分支指针" class="calibre5"/></p>

<p class="calibre2">接下来，你在网站项目上继续工作并作了一次提交。这会使 <code class="calibre9">iss53</code> 分支的指针随着提交向前推进，因为它处于检出状态（或者说，你的 HEAD 指针目前正指向它，见图3-12）：</p>

<pre class="calibre8"><code class="calibre9">$ vim index.html
$ git commit -a -m 'added a new footer [issue 53]'
</code></pre>

<p class="calibre2"><img src="18333fig0312-tn.png" alt="图 3-12. iss53 分支随工作进展向前推进" title="图 3-12. iss53 分支随工作进展向前推进" class="calibre5"/></p>

<p class="calibre2">现在你就接到了那个网站问题的紧急电话，需要马上修补。有了 Git ，我们就不需要同时发布这个补丁和 <code class="calibre9">iss53</code> 里作出的修改，也不需要在创建和发布该补丁到服务器之前花费很多努力来复原这些修改。唯一需要的仅仅是切换回 master 分支。</p>

<p class="calibre2">不过在此之前，留心你的暂存区或者工作目录里，那些还没有提交的修改，它会和你即将检出的分支产生冲突从而阻止 Git 为你转换分支。转换分支的时候最好保持一个清洁的工作区域。稍后会介绍几个绕过这种问题的办法（分别叫做 stashing 和 amending）。目前已经提交了所有的修改，所以接下来可以正常转换到 master 分支：</p>

<pre class="calibre8"><code class="calibre9">$ git checkout master
Switched to branch "master"
</code></pre>

<p class="calibre2">此时工作目录中的内容和你在解决问题 #53 之前一模一样，你可以集中精力进行紧急修补。这一点值得牢记：Git 会把工作目录的内容恢复为检出某分支时它所指向的那个 commit 的快照。它会自动添加、删除和修改文件以确保目录的内容和你上次提交时完全一样。</p>

<p class="calibre2">接下来，你得进行紧急修补。我们创建一个紧急修补分支（hotfix）来开展工作，直到搞定（见图 3-13）：</p>

<pre class="calibre8"><code class="calibre9">$ git checkout -b 'hotfix'
Switched to a new branch "hotfix"
$ vim index.html
$ git commit -a -m 'fixed the broken email address'
[hotfix]: created 3a0874c: "fixed the broken email address"
 1 files changed, 0 insertions(+), 1 deletions(-)
</code></pre>

<p class="calibre2"><img src="18333fig0313-tn.png" alt="图 3-13. hotfix 分支是从 master 分支所在点分化出来的" title="图 3-13. hotfix 分支是从 master 分支所在点分化出来的" class="calibre5"/></p>

<p class="calibre2">有必要作些测试，确保修补是成功的，然后把它合并到 master 分支并发布到生产服务器。用 <code class="calibre9">git merge</code> 命令来进行合并：</p>

<pre class="calibre8"><code class="calibre9">$ git checkout master
$ git merge hotfix
Updating f42c576..3a0874c
Fast forward
 README |    1 -
 1 files changed, 0 insertions(+), 1 deletions(-)
</code></pre>

<p class="calibre2">请注意，合并时出现了 "Fast forward"（快进）提示。由于当前 master 分支所在的 commit 是要并入的 hotfix 分支的直接上游，Git 只需把指针直接右移。换句话说，如果顺着一个分支走下去可以到达另一个分支，那么 Git 在合并两者时，只会简单地把指针前移，因为没有什么分歧需要解决，所以这个过程叫做快进（Fast forward）。</p>

<p class="calibre2">现在的目录变为当前 master 分支指向的 commit 所对应的快照，可以发布了（见图 3-14）。</p>

<p class="calibre2"><img src="18333fig0314-tn.png" alt="图 3-14. 合并之后，master 分支和 hotfix 分支指向同一位置。" title="图 3-14. 合并之后，master 分支和 hotfix 分支指向同一位置。" class="calibre5"/></p>

<p class="calibre2">在那个超级重要的修补发布以后，你想要回到被打扰之前的工作。因为现在 <code class="calibre9">hotfix</code> 分支和 <code class="calibre9">master</code> 指向相同的提交，现在没什么用了，可以先删掉它。使用 <code class="calibre9">git branch</code> 的 <code class="calibre9">-d</code> 选项表示删除：</p>

<pre class="calibre8"><code class="calibre9">$ git branch -d hotfix
Deleted branch hotfix (3a0874c).
</code></pre>

<p class="calibre2">现在可以回到未完成的问题 #53 分支继续工作了（图3-15）：</p>

<pre class="calibre8"><code class="calibre9">$ git checkout iss53
Switched to branch "iss53"
$ vim index.html
$ git commit -a -m 'finished the new footer [issue 53]'
[iss53]: created ad82d7a: "finished the new footer [issue 53]"
 1 files changed, 1 insertions(+), 0 deletions(-)
</code></pre>

<p class="calibre2"><img src="18333fig0315-tn.png" alt="图 3-15. iss53 分支可以不受影响继续推进。" title="图 3-15. iss53 分支可以不受影响继续推进。" class="calibre5"/></p>

<p class="calibre2">不用担心 <code class="calibre9">hotfix</code> 分支的内容还没包含在 <code class="calibre9">iss53</code> 中。如果确实需要纳入此次修补，可以用 <code class="calibre9">git merge master</code> 把 master 分支合并到 <code class="calibre9">iss53</code>，或者等完成后，再将 <code class="calibre9">iss53</code> 分支中的更新并入 <code class="calibre9">master</code>。</p>

<h3 id="calibre_toc_119" class="calibre4">基本合并</h3>

<p class="calibre2">在问题 #53 相关的工作完成之后，可以合并回 <code class="calibre9">master</code> 分支，实际操作同前面合并 <code class="calibre9">hotfix</code> 分支差不多，只需检出想要更新的分支（master），并运行 <code class="calibre9">git merge</code> 命令指定来源：</p>

<pre class="calibre8"><code class="calibre9">$ git checkout master
$ git merge iss53
Merge made by recursive.
 README |    1 +
 1 files changed, 1 insertions(+), 0 deletions(-)
</code></pre>

<p class="calibre2">请注意，这次合并的实现，并不同于之前 <code class="calibre9">hotfix</code> 的并入方式。这一次，你的开发历史是从更早的地方开始分叉的。由于当前 master 分支所指向的 commit (C4)并非想要并入分支（iss53）的直接祖先，Git 不得不进行一些处理。就此例而言，Git 会用两个分支的末端（C4 和 C5）和它们的共同祖先（C2）进行一次简单的三方合并计算。图 3-16 标出了 Git 在用于合并的三个更新快照：</p>

<p class="calibre2"><img src="18333fig0316-tn.png" alt="图 3-16. Git 为分支合并自动识别出最佳的同源合并点。" title="图 3-16. Git 为分支合并自动识别出最佳的同源合并点。" class="calibre5"/></p>

<p class="calibre2">Git 没有简单地把分支指针右移，而是对三方合并的结果作一新的快照，并自动创建一个指向它的 commit（C6）（见图 3-17）。我们把这个特殊的 commit 称作合并提交（merge commit），因为它的祖先不止一个。</p>

<p class="calibre2">值得一提的是 Git 可以自己裁决哪个共同祖先才是最佳合并基础；这和 CVS 或 Subversion（1.5 以后的版本）不同，它们需要开发者手工指定合并基础。所以此特性让 Git 的合并操作比其他系统都要简单不少。</p>

<p class="calibre2"><img src="18333fig0317-tn.png" alt="图 3-17. Git 自动创建了一个包含了合并结果的 commit 对象。" title="图 3-17. Git 自动创建了一个包含了合并结果的 commit 对象。" class="calibre5"/></p>

<p class="calibre2">既然你的工作成果已经合并了，<code class="calibre9">iss53</code> 也就没用了。你可以就此删除它，并在问题追踪系统里把该问题关闭。</p>

<pre class="calibre8"><code class="calibre9">$ git branch -d iss53
</code></pre>

<h3 id="calibre_toc_120" class="calibre4">冲突的合并</h3>

<p class="calibre2">有时候合并操作并不会如此顺利。如果你修改了两个待合并分支里同一个文件的同一部分，Git 就无法干净地把两者合到一起（译注：逻辑上说，这种问题只能由人来解决）。如果你在解决问题 #53 的过程中修改了 <code class="calibre9">hotfix</code> 中修改的部分，将得到类似下面的结果：</p>

<pre class="calibre8"><code class="calibre9">$ git merge iss53
Auto-merging index.html
CONFLICT (content): Merge conflict in index.html
Automatic merge failed; fix conflicts and then commit the result.
</code></pre>

<p class="calibre2">Git 作了合并，但没有提交，它会停下来等你解决冲突。要看看哪些文件在合并时发生冲突，可以用 <code class="calibre9">git status</code> 查阅：</p>

<pre class="calibre8"><code class="calibre9">[master*]$ git status
index.html: needs merge
# On branch master
# Changed but not updated:
#   (use "git add &lt;file&gt;..." to update what will be committed)
#   (use "git checkout -- &lt;file&gt;..." to discard changes in working directory)
#
#   unmerged:   index.html
#
</code></pre>

<p class="calibre2">任何包含未解决冲突的文件都会以未合并（unmerged）状态列出。Git 会在有冲突的文件里加入标准的冲突解决标记，可以通过它们来手工定位并解决这些冲突。可以看到此文件包含类似下面这样的部分：</p>

<pre class="calibre8"><code class="calibre9">&lt;&lt;&lt;&lt;&lt;&lt;&lt; HEAD:index.html
&lt;div id="footer"&gt;contact : email.support@github.com&lt;/div&gt;
=======
&lt;div id="footer"&gt;
  please contact us at support@github.com
&lt;/div&gt;
&gt;&gt;&gt;&gt;&gt;&gt;&gt; iss53:index.html
</code></pre>

<p class="calibre2">可以看到 <code class="calibre9">=======</code> 隔开的上半部分，是 HEAD（即 master 分支，在运行 merge 命令时检出的分支）中的内容，下半部分是在 <code class="calibre9">iss53</code> 分支中的内容。解决冲突的办法无非是二者选其一或者由你亲自整合到一起。比如你可以通过把这段内容替换为下面这样来解决：</p>

<pre class="calibre8"><code class="calibre9">&lt;div id="footer"&gt;
please contact us at email.support@github.com
&lt;/div&gt;
</code></pre>

<p class="calibre2">这个解决方案各采纳了两个分支中的一部分内容，而且我还删除了 <code class="calibre9">&lt;&lt;&lt;&lt;&lt;&lt;&lt;</code>，<code class="calibre9">=======</code>，和<code class="calibre9">&gt;&gt;&gt;&gt;&gt;&gt;&gt;</code> 这些行。在解决了所有文件里的所有冲突后，运行 <code class="calibre9">git add</code> 将把它们标记为已解决（resolved）。因为一旦暂存，就表示冲突已经解决。如果你想用一个有图形界面的工具来解决这些问题，不妨运行 <code class="calibre9">git mergetool</code>，它会调用一个可视化的合并工具并引导你解决所有冲突：</p>

<pre class="calibre8"><code class="calibre9">$ git mergetool
merge tool candidates: kdiff3 tkdiff xxdiff meld gvimdiff opendiff emerge vimdiff
Merging the files: index.html

Normal merge conflict for 'index.html':
  {local}: modified
  {remote}: modified
Hit return to start merge resolution tool (opendiff):
</code></pre>

<p class="calibre2">如果不想用默认的合并工具（Git 为我默认选择了 <code class="calibre9">opendiff</code>，因为我在 Mac 上运行了该命令），你可以在上方"merge tool candidates（候选合并工具）"里找到可用的合并工具列表，输入你想用的工具名。我们将在第七章讨论怎样改变环境中的默认值。</p>

<p class="calibre2">退出合并工具以后，Git 会询问你合并是否成功。如果回答是，它会为你把相关文件暂存起来，以表明状态为已解决。</p>

<p class="calibre2">再运行一次 <code class="calibre9">git status</code> 来确认所有冲突都已解决：</p>

<pre class="calibre8"><code class="calibre9">$ git status
# On branch master
# Changes to be committed:
#   (use "git reset HEAD &lt;file&gt;..." to unstage)
#
#   modified:   index.html
#
</code></pre>

<p class="calibre2">如果觉得满意了，并且确认所有冲突都已解决，也就是进入了缓存区，就可以用 <code class="calibre9">git commit</code> 来完成这次合并提交。提交的记录差不多是这样：</p>

<pre class="calibre8"><code class="calibre9">Merge branch 'iss53'

Conflicts:
  index.html
#
# It looks like you may be committing a MERGE.
# If this is not correct, please remove the file
# .git/MERGE_HEAD
# and try again.
#
</code></pre>

<p class="calibre2">如果想给将来看这次合并的人一些方便，可以修改该信息，提供更多合并细节。比如你都作了哪些改动，以及这么做的原因。有时候裁决冲突的理由并不直接或明显，有必要略加注解。</p>

</body>
</html>
